第 1 步 - 使用 Kanzi Engine API 加载 Kanzi 二进制文件

当使用 C++ 应用程序创建新的 Kanzi Studio 工程时，Kanzi Studio 会使用内含 Kanzi 应用程序模板源代码的 Microsoft Visual Studio 解决方案创建工程。

Kanzi 在 <KanziWorkspace>/Projects/<ProjectName>/Tool_project 目录中创建 Kanzi Studio 工程，并在 <KanziWorkspace>/Projects/<ProjectName>/Application 中创建工程的 Visual Studio 解决方案的结构：

bin 目录包含工程的二进制文件和配置文件。

configs 目录包含不同平台的配置文件。Kanzi 默认为几个不同的平台创建配置文件。适用于开发 Kanzi 应用程序的推荐平台是 Microsoft Visual Studio。请参阅部署 Kanzi 应用程序。

src 包含您的工程的源代码。

教程资产

本教程的起点资料存储在 <KanziWorkspace>/Tutorials/Programmer tutorial/Start 目录中：

Tool_project 目录包含 Kanzi Studio 工程，其中含本教程中使用的应用程序结构和资源。您对工程做了更改时，要在应用程序中查看结果，则要将该工程导出到 kzb 文件中。请参阅使用 kzb 文件。

Application/bin 目录包含从 Kanzi Studio 工程生成的 Programmer_tutorial.kzb 二进制文件，以及您在本教程中创建的应用程序使用的 .png 图像文件。

<KanziWorkspace>/Tutorials/Programmer tutorial/Completed 目录包含本教程已完成的工程。

使用 Kanzi Engine API 加载 Kanzi 二进制文件

要使用 Kanzi Engine API 加载 Kanzi 二进制文件：

在 Kanzi Studio 中打开 <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Tool_project/Programmer tutorial.kzproj Kanzi Studio 工程并选择 > 导出 (Export) > 导出 KZB (Export KZB)。
Kanzi Studio 从 Kanzi Studio 工程创建 kzb 文件和配置文件。Kanzi Studio 将导出的文件存储在 <ProjectName>/Application/bin 目录或您在 > 的二进制导出目录 (Binary Export Directory) 属性中指定的位置。Kzb 文件包含 Kanzi Studio 工程中的所有节点和资源，您在本地化表中标记为本地化包的资源除外。
当您从 Visual Studio 中运行您的 Kanzi 应用程序时，您的应用程序就会加载 kzb 文件和配置文件。

在 Visual Studio 中，打开存储在 <KanziWorkspace>/Tutorials/Programmer tutorial/Start/Application/configs/platforms/win32/Programmer_tutorial.sln 中的解决方案。

注

如果您在 Visual Studio 2017 中打开教程解决方案，遇到提示您重新定位工程到最新的 Microsoft 工具集时，请点击取消 (Cancel)。

在 Visual Studio 中，将 Programmer tutorial 设置为您的启动工程，并打开 programmer_tutorial.cpp 文件。
programmer_tutorial.cpp 文件包含加载 Kanzi 应用程序所需的最少代码量。本教程中，您在文件中创建应用程序的逻辑。

//kanzi.hpp 头文件包括所有 Kanzi Engine 功能。
//要微调应用程序，您可以仅包括相关头文件。
//请参阅 API reference。
#include <kanzi/kanzi.hpp>

using namespace kanzi;
class ProgrammerTutorialApplication: public ExampleApplication
{
    //在 onConfigure 函数中，您可以通知 Kanzi 应用程序
    //要加载的 kzb 文件，启用应用程序中的性能信息，并设置您要使用多少个线程
    //加载该应用程序资源。
    //请参阅 应用程序配置参考。
    virtual void onConfigure(ApplicationProperties& configuration) KZ_OVERRIDE
    {
        configuration.binaryName = "Programmer_tutorial.kzb.cfg";
    }
};

//要使用 Application 框架中的主函数，需要
//在 createApplication 函数中返回您的应用程序。然后，主函数将控件传递给您的应用类中定义的主循环。
Application* createApplication()
{
    return new ProgrammerTutorialApplication;
}

在 Visual Studio 中，为您的 Visual Studio 版本选择一个解决方案配置并运行应用程序。
例如，如果您仍在开发应用程序，选择GL_vs2015_Debug 配置。要创建 Kanzi 应用程序的产品版本，选择一个可用的发布配置。

当您构建和运行该程序时，Kanzi 加载 kzb 文件并显示应用程序内容。

应用程序启动 Kanzi 期间：

调用 onConfigure 入口点函数，您可在指定配置。例如，要该应用程序加载的 Kanzi Studio 工程 kzb 文件以及应用程序窗口尺寸。
将该 kzb 文件加载到内存，就使其可供该应用程序使用。
当 Kanzi 完成工程加载，调用 onProjectLoaded 函数。在本教程的后续步骤中，您可以在函数中增加应用程序功能。

< 简介

下一步 >

第 1 步 - 使用 Kanzi Engine API 加载 Kanzi 二进制文件

教程资产

使用 Kanzi Engine API 加载 Kanzi 二进制文件

另请参阅